From 1e372f57f9c03fcbe7b9af1c5d71b946fa5b24e3 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 29 Mar 2019 11:55:58 -0400 Subject: [PATCH] Don't mark GDK_SURFACE_STATE_TILED as deprecated I've come to the conclusion that we should keep this state, since not all backends support per-edge information. Updated the docs to explain how the tiled state relates to the per-edge states. --- gdk/gdksurface.h | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/gdk/gdksurface.h b/gdk/gdksurface.h index 1ec9ec3318..8f1364f3da 100644 --- a/gdk/gdksurface.h +++ b/gdk/gdksurface.h @@ -356,16 +356,15 @@ struct _GdkGeometry /** * GdkSurfaceState: - * @GDK_SURFACE_STATE_WITHDRAWN: the surface is not shown. - * @GDK_SURFACE_STATE_ICONIFIED: the surface is minimized. - * @GDK_SURFACE_STATE_MAXIMIZED: the surface is maximized. - * @GDK_SURFACE_STATE_STICKY: the surface is sticky. - * @GDK_SURFACE_STATE_FULLSCREEN: the surface is maximized without - * decorations. - * @GDK_SURFACE_STATE_ABOVE: the surface is kept above other surfaces. - * @GDK_SURFACE_STATE_BELOW: the surface is kept below other surfaces. - * @GDK_SURFACE_STATE_FOCUSED: the surface is presented as focused (with active decorations). - * @GDK_SURFACE_STATE_TILED: the surface is in a tiled state. Deprecated + * @GDK_SURFACE_STATE_WITHDRAWN: the surface is not shown + * @GDK_SURFACE_STATE_ICONIFIED: the surface is minimized + * @GDK_SURFACE_STATE_MAXIMIZED: the surface is maximized + * @GDK_SURFACE_STATE_STICKY: the surface is sticky + * @GDK_SURFACE_STATE_FULLSCREEN: the surface is maximized without decorations + * @GDK_SURFACE_STATE_ABOVE: the surface is kept above other surfaces + * @GDK_SURFACE_STATE_BELOW: the surface is kept below other surfaces + * @GDK_SURFACE_STATE_FOCUSED: the surface is presented as focused (with active decorations) + * @GDK_SURFACE_STATE_TILED: the surface is in a tiled state * @GDK_SURFACE_STATE_TOP_TILED: whether the top edge is tiled * @GDK_SURFACE_STATE_TOP_RESIZABLE: whether the top edge is resizable * @GDK_SURFACE_STATE_RIGHT_TILED: whether the right edge is tiled @@ -376,6 +375,11 @@ struct _GdkGeometry * @GDK_SURFACE_STATE_LEFT_RESIZABLE: whether the left edge is resizable * * Specifies the state of a toplevel surface. + * + * On platforms that support information about individual edges, the %GDK_SURFACE_STATE_TILED + * state will be set whenever any of the individual tiled states is set. On platforms + * that lack that support, the tiled state will give an indication of tiledness without + * any of the per-edge states being set. */ typedef enum { -- 2.30.2